OpenEdge Development:<br />Progress Dynamics Advanced Development lookupDisplayComplete event

This event occurs as soon as the lookup has displayed its values into the lookup's fill-in and linked widgets. The difference between the lookupComplete and lookupDisplayComplete hooks is mainly that the lookupDisplayComplete hook fires every time the lookup displays something. This includes when a viewer initializes.

The lookupDisplayComplete event is published from displaylookup in lookup.p with the following parameters:

DEFINE INPUT PARAMETER pcFieldNames AS `CHARACTER` NO-UNDO. DEFINE INPUT PARAMETER pcFieldValues AS `CHARACTER` NO-UNDO. DEFINE INPUT PARAMETER pcKeyFieldValue AS `CHARACTER` NO-UNDO. DEFINE INPUT PARAMETER phlookup AS HANDLE NO-UNDO.

DEFINE INPUT PARAMETER pcFieldNames     AS CHARACTER  NO-UNDO. 
DEFINE INPUT PARAMETER pcFieldValues    AS CHARACTER  NO-UNDO.   
DEFINE INPUT PARAMETER pcKeyFieldValue  AS CHARACTER  NO-UNDO. 
DEFINE INPUT PARAMETER phlookup         AS HANDLE     NO-UNDO.

Table 1–3: lookupDisplayCompleteEvent parameters
Parameter	Description
`pcFieldNames`	A comma-delimited list of field names (in the form `table.fieldname`) that includes the key field, the displayed field, all the selected browse fields, and the selected linked fields, each field appearing only once in the list.
`pcFieldValues`	A `CHR(1)`-delimited list of the corresponding values for the `pcFieldNames`.
`pcKeyFieldValue`	The key field value of the selected record.
`phlookup`	The handle of the lookup SmartDataField instance, used to determine which lookup on your viewer caused the event to occur (in the case where your viewer contains multiple lookups).

To use this event, simply add a procedure to your viewer’s custom super procedure with the name lookupDisplayComplete and the above parameters. Then in initializeObject of your super procedure, before the RUN SUPER statement, add the following line:

SUBSCRIBE PROCEDURE TARGET-PROCEDURE TO "lookupDisplayComplete":U IN TARGET-PROCEDURE.

This event is useful if you want to use the values in the linked fields when the viewer starts up. The lookupComplete hook would not be available at this time, as the lookups have not actually been used yet. It might also be necessary to pass new or linked values on to other viewers, in which case this event would also be useful.